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1.0 INTRODUCTION 

The Consolidated Communications System (CCS) User's Manual describes the 
user input in the form of operator commands and the user outputs in the form 
of displays, hardcopy, and dayfile messages to the CCS. The CCS run 
requirements are also described. 

1.1 CCS Overview 

As part of the Naval Weather Services, the Fleet Numerical Oceanographic 
Center (FNOC) in Monterey, California is the primary location for the 
generation, preparation, and transmission to various customers of 
meteorological and oceanographic data (products). The perishability of such 
products requires a responsive communications system, capable of adequately 
receiving and transmitting a wide variety of environmental products. 

The CCS is defined to include all of the hardware and software which 
interfaces the processing tasks within the Information Processing System 
(IPS) environment to the user circuits which support communications circuits 
(AWN, ID50, NEDS, NEDN, and 200UT) over which data products are transmitted 
and received. It is bounded on one side by the files which are created by 
or for the application jobs (within the IPS), and on the other side by the 
GFE RS-232C patch panel through which products are transmitted or data is 
received. 

The CCS software executing in the MP-32 is composed of several concurrently 
executing tasks which are described below. 

o Inter-Computer Network (ICN) - This software provides a method of 
communication between tasks that span physical mainframes. 

o CYBER Channel Coupler Link Driver (CCCLD) - This software interfaces 
with ICN on the MP-32 to the CYBER Channel Coupler Manager (CCCMGR) 
in MPX/OS, which handles the hardware interface to the IPS. 
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o Network Manager (NM) - This software statuses the IPS computers and 
responds to IPS NM requests to maintain the ICN Machine Table and 
ICN Link Table. 

o Transfer Queue Processor (TQ) - This software creates CCS messages 
from IPS transmit files. It will also perform character translation 
during the transfer when requested. 

o Receive Queue Processor (RQ) - This software creates or adds CCS 
messages received from the remote circuits to either permanent or 
queue files on the IPS. This software will also perform character 
translation during the transfer when requested. 

o Queuer Process (Q) - This software stacks short messages received 
from a remote circuit into a single summed message and then releases 
that message to the CCS message traffic based on time or size. It 
will also perform character translation. y j 

o Message Routing Task (MRT) - This software directs the flow of 
message traffic through the CCS. 

o Protocol Formatting Modules (PA, PB, PC) - This software maps 
circuit format messages to CCS internal format messages and vice 
versa, and communicates with each circuit according to its specific 
protocol. 

o AWN Data Converter (AWNDC) - This software converts AWN Protocol 
outbound messages from ASCII to Baudot and AWN Protocol inbound 
messages from 3audot to either ASCII or binary. 

o System Operator Task (SOT) - This software interfaces with the 
Interactive Terminal Subsystem (ITS) to the CCS application to allow 
the operator to control message processing on the CCS. 
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o Message Editor (MED) - This software enables the CCS operator to 
interface with CCS message traffic. 

o Report Generator (RPGEN) - This software provides a utility for 
statistical summaries of dayfile messages. 
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2.0 REFERENCE DOCUMENTATION 

The following documents are additional references for the user when 
operating the CCS. 

MPX/OS Version 3 Reference Manual 17329125A 

ITS Version 2 Reference Manual 17329140A 

MPX/OS Version 3 Installation Handbook 17329115A 

MP-60 Software Tools User's Manual 17329105C 
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3.0 RUTOING CCS 

. The following tasks must all be loaded and set into execution for the CCS. 
The ordered load of 1 and 2 are critical; otherwise, order is not 
important. All tasks can be initiated by entering the ]J0B ITS command 
where the tasks are as enumerated below. 

- Inter-Computer Network 

- Message Routing 

- Link Driver 

- Network Manager 

- Transmit to Circuit 

- Received from Circuit 

- Queuer Process 

- Protocol Formatting (NMC, ID50) 

- Protocol Formatting (NEDN) 

- Protocol Formatting (AWN) 

11. AWNDC - AWN Protocol Data Converter 

12. SOT - System Operator 
(lun 10 must be open to the SOTMSG.TXT file; 

lun 11 must be open to the SOTCMDS.TXT file.) 

To run the Message Editor or Report Generator, the following tasks 
respectively must be loaded and set into execution: 

13. MED - Message Editor 

14. RPGEN - Report Generator 



1. 


ICN 


2. 


MRT 


3. 


LD 


4. 


NM 


5. 


TQ 


6. 


RQ 


7. 


Q 


8. 


PA 


9. 


PB 


0. 


PC 
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4.0 CCS OPERATOR COMMAND AMD DISPLAY 

The user controls CCS message traffic and views CCS task status via the SOT 
program. Note that operating system status can be obtained using the OCF 
facility. (See the ITS Version 2 Reference Manual.) 

The operator commands fall into three categories. The first category 
consists of the MR commands. These commands interact with the MRT task and 
provide the operator the ability to manipulate routing information such as 
destination, retention, and release time. The operator can also cause 
display of routing information with MR commands. 

The second category comprises the PA, PB , and PC commands. These commands 
configure the circuits, on and off circuits, and display status of the 
configuration. The configuration is established in two steps: first 
creating an entity list (ELIST) via several editing commands for adding, 
deleting, and reading/writing MPX files for ELIST information, and then 
causing the ELIST to become the port configuration (PLIST) via BOOT 
commands. There are also displays of the ELIST and the PLIST. PA handles 
NMC and ID50 circuits; PB handles NEDN circuit; PC handles the AWN circuit. 
All aspects of PA and PB are handled separately (an ELIST for each and so 
forth). Examples in this manual are for PA only. 

The third category consists of the Q commands. These commands display the 
status of message processing between the IPS and CCS. There is also a 
command for manipulation of IPS file characteristics for messages going to 
the IPS. 

To initiate SOT, the user must be in the ICF facility and enter: 

]J0B SOT 
]LINK SOT 
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The SOT task is a multi-user task that up to four terminals/users can use 
concurrently. The operator can terminate usage of SOT by entering the QUIT 
command. This command frees the terminal for other use. 

After using another program, the user can re-link to SOT by entering: 

]LINK SOT or ]KEEP SOT 

The following are SOT Operator Messages that may appear at the terminal: 

Message Meaning 

System Operator Task Title when program starts up. 

Illegal Operator Command. Incorrect type-in. 

Waiting for Response from Task. Not ready for new type-in. 

ICN message size error Incorrect interaction of programs; 

from ICNRECV. contact analyst. 

ICN send error. Incorrect interaction of programs; 

contact analyst. 

Task not available. MRT, ICN, PA, PB , Q, TQ, or RQ not 

executing when needed. 

Task error ICN Buffer Incorrect interaction of programs; 

incorrectly formatted. contact analyst. 

ICN receive error. Incorrect Interaction of programs; 

contact analyst. 

Table 4-1 contains the list of CCS operator commands available via SOT. 
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TABLE 4-1. SOT OPERATOR COMMANDS 



Command 



Description 



o 



1 MR. ADM 

2 MR.CMR 

3 MR. CRT 

4 MR.DKD 

5 MR.DMD 

6 MR. DMI 

7 MR.DML 

8 MR.DMS 

9 MR. DUD 

10 PA. A, PB.A, PC. A 

11 PA. BOOT, PB.BOOT, PC. BOOT 

12 PA.BOOTPFM, PB.BOOTPFM, 

PB .BOOTPFM 

13 PA.CLRLIST, PB.CLRLIST, 

PC.CLRLIST 

14 PA.D, PB.D, PCD 

15 PA.DROP, PB.DROP, PC. DROP 

15 PA.ELIST, PB.ELIST, PC.ELIST 

17 PA. LOAD, PB.LOAD, PC. LOAD 

18 PA. MODE, PB.MODE, PC. MODE 

19 PA.OFF, PB.OFF, PC. OFF 

20 PA. ON, PB.ON, PC. ON 

21 PA.PLIST, PB.PLIST, PC.PLIST 

22 PA.R, PB.R, PCR 

23 PA.SHORTSTAT, PB.SHORTSTAT, 

PC.SHORTSTAT 

24 PA. STATUS, PB. STATUS, 

PC. STATUS 



Add Destination to Message 

Change Message Retention (time) 

Change Release Time (of message to a 
destination) 

Display Known Destinations 

Delete Message Destination 

Display Message Information (of an 
individual message) 

Display Message List (various selection 
criteria) 

Display Message Statistics 

Display Unknown Destinations 

Add entity 

Starts circuit on PA, PB , or PC 

Starts PA, PB, or PC 

Clear entity list 

Delete entity 

Drop all circuits, terminates PA, PB, or PC 

Entity list display 

Load entity list from file 

Set mode field of entity 

Set off status for entity 

Set on status for entity 

Port List display 

Replace entity 

Short form of PA. STATUS, PB. STATUS, or 
PC STATUS 

Status display 



o 



25 PA. STORE, PB. STORE, PC STORE Store entity list on file 
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TABLE 4-1. SOT OPERATOR COMMANDS (Contd) 



o 



Command 



Description 



26 Q 

27 QU. STATUS 

28 RQ.MMT 

29 RQ.MSTATUS 

30 RQ. STATUS 

31 TQ. STATUS 



Terminate usage of SOT 
IPS queued status display 
Change IPS mapping 
IPS mapping status display 
IPS receive status display 
IPS transmit status display 



V / 
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4.1 MR. ADM - Add Destination to Message 

MR. ADM command adds a destination to an existing message. Destination names 
are not checked; a destination name not currently known causes the message 
to be included in the Unknown-Destination category. Message sequence number 
must be currently known. 

MR. ADM, seqnum,destinationname, release time, priority 
where : 

seqnum 1- to 4-digit integer value specifying the sequence 

number 

destinationname maximum 8 ASCII alphanumeric characters specifying 
the destination name (reference appendix C for 
current valid entries) 

releasetime decimal digits in format DDHHMM for day, hour, 

and minute of release (optional; default is 
immediate release) ; a value greater than or equal to 
320000 inhibits release 

priority 1- to 5-digit integer value specifying the priority 

(optional) 

Display Format: 

Seq Sec Size Ret Fmt Type Destination/Release Time yymmddhhmmss 
nnnn s 11111 rrrr ff tt destname/reltim destname/reltim destname/reltim 



where 



yymmdd - date in the format year, month, day 

yy-year 

mm-month 

dd-day 
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hhmmss - time in the format hours, minutes, seconds 



hh-hours 

mm-minutes 

ss-seconds 

nnnn - sequence number 

s - security level 

11111- size in blocks 

rrrr - retention time in minutes 

ff - message format 

tt - message type 

destname - destination name 

reltim - release time in the format hhmmss 

hh-hours 

mm-minutes 

ss-seconds 



Sample entry and response: 

MR.ADM,0268,NMCSU 

Seq Sec Size Ret Fmt Type Destination/Release Time 820909134922 

0268 00002 0030 AS MS AWNC /UNKWN NMCSU /UNKWN 

4.2 MR.CMR - Change Message Retention Time 

MR.CMR changes the period of time that the message is to remain queued after 
transmission to the last destination. 

MR.CMR,seqnum,retention 

where: 

seqnum 1- to 4-digit integer value specifying the sequence 

numbers 

retention New retention time in minutes; integer value from 
to 4096 
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Display Format: 

Seq Sec Size Ret Fmt Type Destination/Release Time yymmddhhmmss 
nnnn s 11111 rrrr ff tt destname/reltim destname/reltim destname/reltim 

where : 

yymmdd - date in the format year, month, day 

yy-year 

mm-month 

dd-day 

hhmmss - time in the format hours, minutes, seconds 

hh-hours 

mm-minutes 

ss - seconds 

nnnn - sequence number 

s - security level 

11111- size in blocks 

rrrr - retention time in minutes 

ff - message format 

tt - message type 

destname - destination name 

reltim - release time in the format hhmmss 

hh-hours 

mm-minutes 

ss-seconds 



o 



o 
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Sample entry and response: 

MR.CMR,0268,20 

Seq Sec Size Ret Fmt Type Destination/Release Time 820909140445 

0268 00002 0020 AS MS AWNC /UNKWN NMCSU /UNKWN 

4.3 MR.CRT - Change Release Time 

MR. CRT changes the time at which the message is released for transmission to 
the destination specified. 

MR.CRT,seqnum,destinationname, release time 
where: 

seqnum 1- to 4-digit integer value specifying the sequence 

number 

destinationname maximum 8 ASCII alphanumeric characters specifying 
the destination name (reference appendix C for 
current valid entries) 

releasetime decimal digits in format DDHHMM for day, hour, and 
minute of release; a value of 000000 causes 
immediate release; a value greater than or equal to 
320000 presents release 



Display Format: 

Seq Sec Size Ret Fmt Type Destination/Release Time yymmddhhmmss 
nnnn s 11111 rrrr ff tt destname/reltim destname/reltim destname/reltim 

where : 

yymmdd - date in the format year, month, day 

yy-year 

mm-month 

dd-day 



o 
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hhmmss - time in the format hours, minutes, seconds 

hh-hours 

mm-minutes 

ss-seconds 

nnnn - sequence number 

s - security level 

11111- size in blocks 

rrrr - retention time in minutes 

ff - message format 

tt - message type 

destname - destination name 

reltim - release time in the format hhmmss 

hh-hours 

mm-minutes 

ss-seconds 

Sample entry and response: 

MR. CRT, 268, NMCSU, 20000 

Seq Sec Size Ret Fmt Type Destination/Release Time 820909140059 

0268 00002 0030 AS MS AWNC /UNKWN NMCSU /UNKWN 

4.4 MR.DKD - Display Known Destinations 

MR.DKD causes display of a header and up to 22 lines of known destinations. 
These destinations are grouped by Destination Group Name. If 
destinationgroupname is specified, the display will begin with that 
Destination Group. 
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MR.DKD,destinationgroupname 

where : 

destinationgroupname maximum 8 alphanumeric characters specifying the 

destination group name (reference appendix C for 
current valid entries) (optional) 

Display Format: 

Groupname Destination names 

gggggggg: xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx 

xxxxxxxx xxxxxxxx 
where : gggggggg - destination group name 
xxxxxxxx - destination name 

Sample entry and response: 



MR.DKD 

Groupname Destination names 

NEDNE : KNWCW 



4.5 MR.DMD - Display Message Destination 

MR.DMD removes the specified destination from the message specified. 

MR.DMD,seqnum,destinationname 

where : 

seqnum 1- to 4-digit integer value specifying the 

sequence number 

destinationname maximum 8 ASCII alphanumeric characters specifying 
the destination name (reference appendix C for 
current valid entries) 

Display Format: 

Seq Sec Size Ret Fmt Type Destination/Release Time yymmddhhmmss 
nnnn s 11111 rrrr ff tt destname/reltim destname/reltim destname/reltim 
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where : 

yymmdd - date in the format year, month, day 

yy-year 

mm-month 

dd-day 

hhmmss - time in the format hours, minutes, seconds 

hh-hours 

mm-minutes 

ss-seconds 

nnnn - sequence number 

s - security level 

11111- size in blocks 

rrrr - retention time in minutes 

ff - message format 

tt - message type 

destname - destination name 

reltim - release time in the format hhmmss 

hh-hours 

mm-minutes 

ss— seconds 

Sample entry and response: 



MR.DMD,0268,NMCSU 

Seq Sec Size Ret Fmt Type Destination/Release Time 820909140558 

0268 00002 0020 AS MS AWNC /UNKWN 



o 
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4.6 MR.DMI - Display Message Information 

MR.DMI causes message Information about an individual message to be 
displayed. 

MR.DMI, seqnum 

where : 

seqnum 1- to 4-digit integer value specifying the sequence 

number of the message 

Display Format: 

Circuit Station Receipt Jobname Date/Time 
ccccc sssss ddhhmm jjjjjjj yymmddhhmm 

Message Id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

Initial Destinations: 

Dest Pri Release MDL Product f A 

ddddd pppp ddhhmm mmmmm rrrrr V_y 

Current Information: 

Seq Sec Size Ret Fmt Type Destination/Release Time yymmddhhmmss 

nnnn s 11111 rrrr ff tt sinkname/reltim sinkname/reltim sinkname/reltim 

sinkname/reltim sinkname/reltim sinkname/reltim 

where : 

ccccc - circuit name 
sssss - station name 

ddhhmm - time of receipt of message in format day, 
hours, minutes 

dd - day 
hh - hours 
mm - minutes 
jjjjjjj J ~ job name identifier 

yymmddhhmm - date and time in format year, month, day, hours, minutes 

yy - year 
mm - month 
dd - day 
4-12 
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hh - hours 
mm - minutes 

xx.... xx - message id 

ddddd - destination name 

PPPP ~ priority 

ddhhmm - release time in format days, hours, minutes 

dd - days 

hh - hours 

mm - minutes 
tmnmmm - MDL 
rrrrr - product 

nnnn - sequence number 

s - security level 

11111- size in blocks 

rrrr - retention time in minutes 

ff - message format 

tt - message type 

sinkname - sink (destination) name 

reltim - release time in the format hhmmss 

hh-hour s 

mm-minutes 

ss - seconds 

Sample entry and response: 



MR. DM1,0268 

Circuit Station Reciept Jobname Date/Time 

AWNO AWNO 451844 AWNO 451617 

Message Id: 

Initial Destinations: 

Dest Pri Release MDL Product 

AWNC 0000 0000 
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Current Information: 

Seq Sec Size Ret Fmt Type Destination/Release Time 820909135525 

0268 00002 0030 AS MS AWNC /UNKWN NMCSU /UNKWN 






4.7 MR.DML - Display Message List 

MR.DML causes a header and 22 lines of message information to be listed on 
the screen. Only messages meeting the criteria (ALL, HOLD, XMIT, etc.) will 
be displayed. If seqnum is nonzero, then display will begin with the 
message of the given sequence number. If destinationgroupname is included, 
then only messages queued to the specified Destination Group will be 
displayed. 



MR.DML [, seqnum] [,ALL] [.destinationgroupname] 
[ ,H0LD] 
[,XMIT] 
[.WAIT] 
[,RET] 
[ , UNKWN] 
where : 
seqnum 



specifying the 



1- to 4-digit integer value 
sequence number (optional) 

destinationgroupname maximum 8 alphanumeric characters specifying the 

destination group name (reference appendix C for 

current valid entries); if not specified, all 
destination groups are displayed 






ALL 

HOLD 

XMIT 

WAIT 
RET 

UNKWN 



display all destinations in group 

display all destinations in group in Hold Queue 

display all destinations in group in Transmit 

Queue 

display all destinations in group in Wait Queue 

display all destinations in group in Retention 

Queue 

display all destinations in group in destinations 

not being processed by CCS 
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Display Format: 

Seq Sec Size Ret Fmt Type Destination/Release Time yymmddhhmmss 
nnnn s 11111 rrrr ff tt destname/reltim destname/reltim destname/reltim 

where : 

yymmdd - date in the format year, month, day 

yy-year 
mm-month 
d d-day 

hhmmss - time in the format hours, minutes, seconds 

hh-hours 

mm-minutes 

ss-seconds 

nnnn - sequence number 

s - security level 

11111- size in blocks 

rrrr - retention time in minutes 

ff - message format 

tt - message type 

destname - destination name 

reltim - release time in the format hhmmss 

hh-hours 

mm-minutes 

ss-seconds 
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Sample entry and response: 



o 



MR. DML, 0268, ALL 

Seq Sec Size Ret Fmt Type Destination/Release Time 820909135714 

0268 00002 0030 AS MS AWNC /UNKWN NMCSU /UNKWN 



0224 


00053 


0120 AS 


MS 


OFFUT 


/UNKWN 






02 21 2 


00008 


0003 AS 


OP 


S4 


/UNKWN 


SI 


/UNKWN 


0225 


00062 


0120 AS 


MS 


KNWCW 


/XMIT 






0231 


00044 


0120 AS 


MS 


CARSW 


/UNKWN 






0251 


01420 


0120 BN 


GR 


CARSW 


/UNKWN 






0232 


00053 


0120 AS 


MS 


OFFUT 


/UNKWN 






0235 


00062 


0120 AS 


MS 


CARSW 


/UNKWN 


OFFUT 


/UNKWN 


0239 


00270 


0120 BN 


FB 


CARSW 


/UNKWN 






0241 


00114 


0120 BN 


FB 


CARSW 


/UNKWN 


NMCSU 


/UNKWN 


0244 


00260 


0030 AS 


SM 


OFFUT 


/UNKWN 






0252 


00848 


0120 BN 


GR 


CARSW 


/UNKWN 


OFFUT 


/UNKWN 


1607 


00004 


0000 AS 


OP 


OPRMSG 


/UNKWN 






1647 


00848 


0000 BN 


MS 


NMCDATA /UNKWN 






1612 


00003 


0000 AS 


OP 


OPRMSG 


/UNKWN 






4.8 MR.DMS • 


- Display Message Statistics 







MR.DMS causes generation of a Message Statistics Display. 



MR.DMS 



Display Format: 



Description Number 


%Max 


Tota 1-Msgs nnnn 


mmm 


Ret-Msgs nnnn 




Unk-Dest-Msgs nnnn 




Msg/Dest Links nnnn 


TTimrn 


Destinations nnnn 


TtrmTn 



Disk Blocks %Max 

bbbbb mmm 

b bbbb mmm 

bbbbb mmm 



yymmddhhmmss 



Max Disk Blocks » ddddd 



Unused GC space = uuuuu 



where : 

yymmdd - date in the format year, month, day 

yy - year 
mm - month 
dd - day 
hhmmss - time in the format hours, minutes, seconds 

hh - hours 
mm - minutes 
ss - seconds 
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nnnn -; number of messages 
mmm - percentage used of maximum available 
bbbbb - disk blocks allocated for messages 
ddddd - maximum number of disk blocks 
uuuuu - unused global common space 

Sample entry and response: 



MR.DMS 

Description Number 
Total-Msgs 0026 
Retained-Msgs 0000 
Unk-Dest-Msgs 002 5 
Msg/Dest Links 0034 
Destinations 0013 

Max Disk Blocks = 03000 



%Max 


Disk Blocks 


%Max 


013 


00073 


002 




00000 


000 




00071 


002 


007 






010 







820909140759 



Unused GC space = 02567 



^LJ' 



4.9 MR. DUD - Display Unknown Destinations 

MR. DUD causes display of a header and up to 22 lines of information about 
messages that cannot currently be delivered to their stated destinations. 
If destinationname is specified, the display will begin with that 
destination. 

MR. DUD, destinationname 

where : 

destinationname maximum 8 ASCII alphanumeric characters specifying 

the destination name (optional) (reference to 
appendix C for current valid entries) 

Display Format: 



o 



Dest. Message Sequence Numbers 
xxxxx nnnn nnnn nnnn nnnn nnnn nnnn 
where : 

xxxxx - destination name 

nnnn - message sequence number 



» . . . nnnn 
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o 



Sample entry and response: 

MR. DUD 

Best. Message Sequence Numbers 

54 0125 0221 
SI 012 5 0221 

55 0128 

56 0128 

57 0128 
KNGUE 0201 0202 

CARSW 0227 0223 0231 0251 0235 0239 0241 0252 

OFFUT 0244 0227 0224 0232 0235 0252 

AWNC 0264 0261 0265 0266 0267 0268 

NMCSU 0241 

OPRMSG 1607 1612 

NMCDATA 1647 

4.10 PA.A, PB.A, PC.A - Add Entity 

PA. A, PB.A, PC.A adds a new entity specification at the end of the Entity 
Name List. Returns Entity Name List display to operator. (See appendix E.) 

PA. A, name , type , s tat ,mode , security , subname 
where : 



v.„y 



name 
type 
stat 
mode 



entity name; maximum 8 alphanumeric characters 

protocol: NEDN, NEDS, AWN, ID50, NMC 

port status: ON, OFF 

for type NEDN: A - wait and send to NEDS when 

they are all online 

B - send to all NEDS; those 

offline will lose the message 

C - send to available NEDS now; 
wait and send to others when 
available 

for type AWN: D - double buffer 

S - single buffer 

ignored for other types (NEDS ,ID50, NMC) 



security integer value to 255 

subname subordinate entity name; must be entity to which 
entity is subordinate 
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4.11 PA.BOOT, PB.BOOT, PC. BOOT - Starts Circuit 

PA. BOOT, PB.BOOT, PC. BOOT terminates circuit tasks for a specified port at 
first opportunity afforded by the protocol. Rebuilds Port List entry for 
specified port. Initiates circuit tasks for specified port. Returns Port 
List display to operator. (See appendix E. ) 

PA. BOOT, port 
where : 

port port number; integer value 

4.12 PA.BOOTPFM, PB.BOOTPFM, PC.BOOTPFM - Start PA, PB, or PC 

PA.BOOTPFM, PB.BOOTPFM, PC.BOOTPFM terminates all active circuit tasks at 
the first opportunity afforded by each protocol. Builds Port List from 
entity Name List. Initiates circuit tasks. Returns Port List display to 
operator. (See appendix E. ) 

PA.BOOTPFM 

4 «13 PA.CLRLIST, PB.CLRLIST, PC.CLRLIST - Clear Entity List 

PA.CLRLIST, PB.CLRLIST, PC.CLRLIST clears Entity Name List to empty. 
Returns an empty Entity Name List display to operator. (See appendix E.) 

PA.CLRLIST 

4.14 PA.D, PB.D, PCD - Delete Entity 

PA.D, PB.D, PCD deletes an entity specification from the Entity Name List. 
Returns Entity Name List display to operator. (See appendix E. ) 
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PA.D,ord 

where : 

ord ordinal number (ELIST entry number); integer value 

4.15 PA.DROP, PB.DROP, PC. DROP - Drop All Circuits on PA, PB, or PC 

PA.DROP, PB.DROP, PC. DROP terminates all circuit tasks at the first 
opportunity afforded by each protocol. Terminates the OPER task of PFM. If 
no other tasks are active, PFM will terminate as an MPX/OS task. 

PA.DROP 

4.16 PA.ELIST, PB .ELIST, PC. ELIST - Entity List Display 

PA. ELIST, PB. ELIST, PCELIST returns Entity Name List display to operator. 
(See appendix E.) 

PA.ELIST 

4.17 PA.LOAD, PB.LOAP, PC. LOAD - Load Entity List From File 

PA. LOAD, PB.LOAD, PCLOAD loads specified file (fn) containing 
specifications for entities. Appends file of entities to Entity Name List. 
Returns Entity Name List display to operator. (See appendix E.) 

PA.LOAD, fn, owner, ed, ace 
where : 

fn MPX/OS file name 

owner MPX/OS file owner 

ed MPX/OS file edition 

ace MPX/OS file access key 



o 



v.y 



~> 
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4.18 PA.MODE, PB.MODE, PC.MODE - Set Entity Mode 

PA. MODE, PB.MODE, PC.MODE sets the mode field of the named entity in the 
Port List to the specified value (mode). This change of mode will take 
place automatically at the first opportunity afforded by the protocol 
without the necessity of BOOTing the port. Returns the Status Display to 
the operator. (See appendix E. ) 



o 



PA. MODE , name , mode 
where : 
name 
mode 



entity name 

for type NEDN: A - wait and send to NEDS when 

they are all online 

B - send to ALL NEDS; those 

offline will lose the message 

C - send to available NEDS now; 
wait and send to others when 
available 



for type AWN: 



D - double buffer 
S - single buffer 



4.19 PA. OFF, PB.OFF, PC. OFF - Set Entity to OFF 

PA. OFF, PB.OFF, PC. OFF sets the status field of the named entity in the Port 
List to OFF. This change will take place automatically at the first 
opportunity afforded by the protocol without the necessity of BOOTing the 
port. Returns the Status Display to the operator. (See appendix E.) 



PA. OFF, name 
where : 
name 



entity name 
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4 - 20 PA.ON, PB.ON, PC. ON - Set Entity to ON 

PA. ON, PB.ON, PC. ON sets the status field of the named entity in the Port 
List to ON. This change will take place automatically at the first 
opportunity afforded by the protocol without the necessity of BOOTing the 
port. Returns the Status Display to the operator. (See appendix E.) 

PA. ON, name 

where: 

name entity name 

4*21 PA.PLIST, PB.PLIST, PC.PLIST - Display Port List 

PA.PLIST, PB.PLIST, PC.PLIST returns Port List display to operator. (See 
appendix E. ) 

PA.PLIST 



o 



v_y 



4.22 PA.R, PB.R, PC.R - Replace Entity 

PA.R, PB.R, PC.R replaces the entity specification at the specified ordinal 
(ord) with the new specification. Returns the Entity Name List display to 
the operator. (See appendix E. ) If the specified ordinal is not found, 
then this command has no effect. 

PA. R, ord ,name , type , s tat , port , security , subname 
where : 

ord ordinal number (ELIST entry number); integer value 

name entity name 

type protocol: NEDN, NEDS, AWN, ID50, NMC 

stat port status: ON, OFF 

port port number; integer value to 54 

security integer value to 255 

subname subordinate entity name; must be entity to which name is a 



subordinate 
4-22 
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4.23 PA.SHORTSTAT, PB.SHORTSTAT, PC.SHORTSTAT - Short Form of PA.STATUS, 
PB. STATUS, PC. STATUS 

PA.SHORTSTAT, PB.SHORTSTAT, PC.SHORTSTAT returns short form of the 
PA.STATUS, PB. STATUS, or PC. STATUS Display, including station and status 
only, to the operator. (See appendix E. ) 

PA. SHORTSTAT 

4.24 PA.STATUS, PB. STATUS, PC. STATUS - Status Display 

PA.STATUS, PB. STATUS, PC. STATUS returns the Status Display to the operator. 
(See appendix E.) 

PA.STATUS 

4.25 PA.STORE, PB. STORE, PC. STORE - Store Entity List on File 

PA. STORE, PB. STORE, PC. STORE saves the Entity Name List on the specified 
file. Returns Entity Name List display to operator. 

PA. STORE , f n , owner , ed , ace 
whe re : 

fn MPX/OS file name 
owner MPX/OS file owner 
ed MPX/OS file edition 
ace MPX/OS file access key 

4.26 Q - Terminate Connection to SOT 

Q terminates connection to SOT. 
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4.27 QU. STATUS - IPS Queued Status Display 

QU. STATUS 



o 



QU. STATUS displays status of messages processed by Q. These messages are 
the ones summed into a larger message for transmittal to the IPS. 



ORD 



oo 



SINKNAME 


TIME 


MESSAGE SIZE 




TX CUR 


TRANSMIT CURRENT 


nnnnnn 


tt cc 


ssssss 111111 



where : 

oo - ordinal number 

nnnnn - skink name 

tt - transmit time 

cc - current time 

ssssss - transmit message size 

111111 - current message size ^J 1 

Sample display: 

ORD SINKNAME TIME MESSAGE SIZE 

TX CUR TRANSMIT CURRENT 

1 AWNRAW 15 7 200000 100000 

4.28 RQ.MMT - Change IPS File Mapping 

RQ.MMT changes the IPS File for the ordinal selected. There is one ordinal 
and one filename associated with a destination (sink) at any given time. 

RQ.MMT, 0RD=nn,FT=[PF,QF,QU],LFN=fff ,ID=ii,CN=ccc,MD=mmm,RD=»rrr,RP=retention, 
MF=xxx. 
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where: 

nn integer 1 to 20; current valid values in RQ.MSTATUS 

fff up to 28 alphanumeric characters; IPS filename 

ii 2 alphanumeric characters; IPS catalog id 

ccc 8 alphanumeric characters; IPS control password for fff 

mmm 8 alphanumeric characters; IPS modify password for fff 

PF to permanent file fff 

QU to Queue file fff 

QF to Queue file where 3 characters are from fff, last 4 

characters are from HHMM 

rrr 8 alphanumeric characters; IPS read password for fff 

retention minutes; integer value from to 4096 

xxx mainframe; 3 alphanumeric characters. 

Current valid values: BON, CLY, SPC, HAL, DLA 

4.2 9 RQ.MSTATOS - Display IPS Mapping Status 

RQ.MSTATUS displays status of IPS receive files. 

RQ.MSTATUS 

Display format: 
ORD MF SINKNAME TYPE FILENAME ID RP READ CONTROL MODIFY EXTEND 

oo mmm ssssssss tt ff ff f ffffffff f ii ppp rrrrrrrr cccccccc xxxxxxxx eeeeeeee 



• * 



• • 



• • 



oo mmm ssssssss tt ffffffffff fff f ii ppp rrrrrrrr cccccccc xxxxxxxx eeeeeeee 



o 
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where : 

oo - ordinal number 

mmm - mainframe (BON, CLY, SPC, HAL, DLA) 

ssssssss - sink name 

tt - type (PF - permanent file, QU - queue file) 

ffffffffffffff - Filename 

ii - file id 

rp - repeat count 

rrrrrrrr - read file password 

cccccccc - control file password 

xxxxxxxx - modify file password 

eeeeeeee - extend file password 

Sample display: 

ORD MF SINKNAME TYPE FILENAME ID RP READ CONTROL MODIFY EXTEND 

10 BON NMCDATA PF THISISAFAIRLYL ZW 999 PWREADIN PWCONTRL PWMODIFY PWEXTEND 

ONGFILENAMETOO 

11 CLY AWNDATA PF NOTSOLONALFN NP 099 PWREADAW PWCONAWN PWMODAWN AWN V 

12 BOL ARQDATA PF SHORTFILE NP 010 PLD BLUE ORANGE YELLOW 

13 SPC ID50DATA QU RXQHHMM 

4.30 RQ. STATUS - Display IPS Receive Status 

RQ. STATUS displays status of each IPS destination (sink). 

RQ. STATUS 

Display format: 

MF ST SINKNAME MESSAGE NAME SL SIZE RP 

fff t nnnnnnnn immTiinmmmmmmmm 1 sssss rrr 



fff t nnnnnnnnn mmmmmmmmmmmm 1 sssss rrr 
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where: 

fff - mainframe (BON, CLY, SPC, HAL, DLA) 

t - status 

nnnnnnnn - sink name 

mmm mmmmmrnmrn m ~ message name 

1 - sink length 

sssss - message size 

rrr - repeat 

Sample display: 

MF ST SINKNAME MESSAGE NAME SL SIZE RP 



BON A AWNDATA QUEUED. .0134 

CLY C NMCDATA QUEUED. .1401 

SPC D NEDNDATA QUEUED. .1200 

HAL F ID50D ATA QUEUED.. 0101 6 

DLA H ARQDATA QUEUED. .0225 



4.31 TQ. STATUS - Display IPS Transmit Status 



4 


700 


4 





4000 


4 


2 


200 


6 


6 


2050 


10 


3 


10 


2 



o 



TQ. STATUS displays status of IPS transmit files. 



TQ. STATUS, xxx 



where : 
xxx 



mainframe; 3 alphanumeric characters; if not specified, 
all mainframes are displayed. 

Current valid values: BON, CLY, SPC, HAL, DLA 



Display format: 

MF ST FILE FNT SL CRP PRI SIZE 
mmm t ffffffff nnnn 1 ccc pp ssss 



Tnrnni 



t ffffffff nnnn 



ccc 



pp 



ssss 



where : 

mmm - mainframe (BON, CLY, SPC, HAL, DLA) 
t - status 
ffffffff - filename 
nnnn - FNT entry address 
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1 - sink length 
ccc - CYBER repeat 
pp - priority 
ssss - size 

Sample display for TQ. STATUS: 

MF ST FILE FNT SL CRP PRI SIZE 

BON A FILE007 4342 1 896 7 7777 

CLY C FILE001 4444 5 700 6 6012 

HAL F FILEABE 4134 800 7 100 

SPC G FILE1 4702 1 110 1 100 

Sample display for TQ. STATUS, xxx: 

MF ST FILE FNT SL CRP PRI SIZE 

XXX G 



FILEAAA 


4304 


5 


200 


7 


400 


FILEB 


4400 


4 


200 


7 


500 


FILE002 


4144 


1 


100 


5 


100 


FILE001 


4147 


1 


300 


2 


1000 


FILE010 


4301 


1 


70 


1 


100 


FILE011 


4212 


3 


250 


1 


400 



vy 
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5.0 MESSAGE EDITOR (MED) 

The -Message Editor (MED) provides the operator with an interface to receive 
and send message traffic. 

The ITS command under ICF facility to run MED is: 

]J0B MED 

5.1 Top Level MED Coamands 

After getting into MED, there is a choice of top level commands as described 
in this section. 

RCV - receives a message that was destined to MED by a task or the operator. 
RCV,seqnum 
where : 

seqnum a message sequence number 
NEW - creates a new message. 

NEW 
READ - reads the file specified and associated CX edition of the same 
filename for context (if any) and initializes the message with the 
contents of the file, binary or alpha, as specified in the file 
header. The file must reside under owner MED. 
READ filename 
where: 

filename an MPX filename 
Q - quit MED. 
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5.2 MED Commands for Creating Messages 

After proper entry of top level commands RCV, NEW, or READ, any of the 
following commands can be used. 

CX - context viewing or changing. 

Syntax: 
CX 

After entering the CX command, the following commands can be used to 
view and/or change the context: 

s, level set security level; to 7 

l,len set length of message in bits 

r, re tain set retention period in minutes „ — 

d,dest set destination name V„y' 

p, prior set priority; integer 

t,time set time of release; ddhhmm integer value 

i,pid set product id; 8 alphanumeric characters 

n position to next destination, 

nd delete destination 

na,dest append destination 

n$ position to last destination 

nl position to Ith destination 

q quit context viewing and changing, back to FA, CX, 
and so forth, level of commands 

After each entry of a new value the global context and the current 
destination valves are redisplayed. 

Defaults for values are levelO.len^O.retainO.d^no default, 
prior=»0,time=0,pid=0. 
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FA - freeform alpha input, user is then in a mini editor to enter text. 

Syntax: 
"" FA, len 

where : 

len length of message in characters 

The editing commands for FA are: 

A - for adding new lines; enter text then a line with a period in 

column 1 
D - delete last line in buffer 
L - list entire buffer 
Q - quit editing portion, back to FA, CX, etc., level of commands. 

CA - MED creates a canned message of the length (in characters) specified 
C P with the one character repeated (the character cannot be a carriage 

return) . 

Syntax : 

CA, len, char 
where : 

len length of message in characters 
char one ASCII character 

IA - MED creates a canned message of the length (in characters) specified 
with the one character incremented (7-bit ASCII) with rollover (the 
character cannot be a carriage return) . 

Syntax : 

IA, len, char 
where : 

len length of message in characters 
char one ASCII character 



o 
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CB - MED creates a canned message of the length (number of values) specified (|^Ji< 
with the hex or binary digits repeated. 

Syntax: 

CB, len, val 
where : 

len length of message (number of repetitions of val) 
val hexadecimal or binary digits (B for binary) 

IB - MED creates a canned message of the length (number of values) specified 
with the hex or binary value incremented by one with rollover. 

Syntax: 

IB, len, val 
where : 

len length of message (number of repetitions of val) 

val hexadecimal or binary digits (B for binary) 

r -x 

SV - The message content currently being edited by MED is saved in the file. 
The context is saved in a companion file with the same name, except the 
edition is CX. The user is prompted for overwrite Y/N if files already 
exist. The file is saved under owner MED. 

Syntax: 

SV, filename 
where : 

filename MPX filename 

SN - Send the message. The context must be appropriate or the MED will not 
send and will display an error message. 

Syntax: 
SN 



\ 
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6.0 REPORT GENERATOR (RPGEN) 

The Journal Report Generator is a FORTRAN utility that will obtain and 
generate statistics oriented towards day reports and problem analysis. 

The Report Generator produces a statistical report profiling the specified 
time span and system dayfile input. This is accomplished by obtaining those 
dayfile entries containing relevant information as identified by the CODE 
field of the dayfile entry. An analysis of these dayfile entries is then 
performed resulting in a report which can be output to a hard or soft copy 
d evic e . 

Calling Sequence: 

*RPGEN (P p P 2 , . . . P n ) 
where: 

P £ is any of the following in any order: 

I = Lu Input file from logical unit Lu. Default is the 
system dayfile. 

L = Lul/Lu2 Output file(s) to logical unit Lul or to an 
optional logical unit Lu2. Default is logical unit 
63. 

Start time for extractor, hour, integer to 23. 
Default is beginning of dayfile. 

Stop time for extractor. 

Default is end of dayfile, hour, integer to 23. 

Extract throughput rates at hourly intervals. * 

Extract effective throughput rates at hourly 
intervals (TH-RH) . * 

Extract retransmission rates at hourly intervals. * 
Compute overall throughput rates. * 



o 



Tl 


_ 


hh 


T2 


= 


hh 


TH 






EH 






RH 
TO 
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TR 
RE 
CI 

CE 
AC 
SA 

ER 



Compute options TH, EH, RH, and TO. * 

Produce error summary. * 

Extract circuit traffic, summary from day file 
access codes TX, TA, RX, and RA. * 

Extract circuit traffic, expanded. * 

Extract accounting information. * 

Extract and list security access attempts. * 

Extract error summaries. * 



* Default extraction options = all. 



Dayfile messages extracted by code 
Identification (I) 

R RNCI dayfile message 



(IEAA) 



Event (E) 
S 

Action (AA) 
TX 
TA 
RX 
RA 
RT 
RN 
TP 
AC 
SL 
PE 
ER 



Status dayfile message. 

CCS successful transmission. 

CCS abort transmission. 

CCS successful receipt of message. 

CCS abort receipt of message. 

Bits retransmitted this past hour. 

Number of bits retransmitted this past hour. 

Number of bits transmitted this past hour. 

Accounting information for this circuit. 

Security activity on this circuit. 

Circuit processing errors. 

Processing errors. 






Input 
Option 

AC 



Dayfile Action 
Code Used 

AC 



Description 

A listing of all accounting information 
by circuit. 



o 
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Sample output: 



ACCOUNTING INFORMATION 



CIRCUIT 



NMC All dayfile messages with code RSAC for NMC 

AWNO All dayfile messages with code RSAC for AWNO 

AWNC All dayfile messages with code RSAC for AWNC 

NEDNE All dayfile messages with code RSAC for NEDNE 

NEDNW All dayfile messages with code RSAC for NEDNW 

NEDNL All dayfile messages with code RSAC for NEDNL 

ID50 All dayfile messages with code RSAC for ID50 



o 



Input 
Option 



Dayfile Action 
Code Used 



CE TX,TA,RX,RA 

Sample output: 



Description 

A listing by circuit of all circuit 
traffic by the dayfile action code. 



o 



CIRCUIT TRAFFIC 



CIRCUIT 



NMC All dayfile messages with code RSTx for NMC 

AWNO All dayfile messages with code RSTx for AWNO 

AWNC All dayfile messages with code RSTx for AWNC 

NEDNE All dayfile messages with code RSTx for NEDNE 

NEDNW All dayfile messages with code RSTx for NEDNW 

NEDNL All dayfile messages with code RSTx for NEDNL 

ID50 All dayfile messages with code RSTx for ID50 
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Input Dayfile Action 

Option Code Used Description 

CT TX,TA,RX, RA A summary of all circuit traffic. CT 

will give the number of transactions for 
each circuit by the dayfile action code. 
Sample output: 

CIRCUIT TRAFFIC SUMMARY 



CIRCUIT 


ACTION CODE 


NUMBE 


NMC 


TX 


NN 


AWNO 


TX 


NN 


AWNC 


TX 


NN 


NEDNE 


TX 


NN 


NEDNW 


TX 


NN 


NEDNL 


TX 


NN 


ID50 


TX 


NN 


NMC 


TA 


NN 


AWNO 


TA 


NN 


AWNC 


TA 


NN 


NEDNE 


TA 


NN 


NEDNW 


TA 


NN 


NEDNL 


TA 


NN 


ID50 


TA 


NN 


NMC 


RX 


NN 


AWNO 


RX 


NN 


AWNC 


RX 


NN 


NEDNE 


RX 


NN 


NEDNW 


RX 


NN 


NEDNL 


RX 


NN 


ID50 


RX 


NN 


NMC 


RA 


NN 
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AWNO 






RA 




NN 




AWNC 






RA 




NN 




NEDNE 
NEDNW 
NEDNL 
ID50 






RA 
RA 
RA 
RA 




NN 
NN 
NN 
NN 


Input 
Option 


Dayf ile 
Code 


Action 

Used 




Effect 


Description 


EH 




tp,: 


RN 


ive throughput rate 












intervals (TH-RH) . 



at hourly 



Sample output: 



o 



EFFECTIVE THROUGHPUT RATE 



CIRCUIT HOUR BIT TRANS. (10 thousands) 



NMC 

AWNO 

AWNC 

NEDNE 

NEDNW 

NEDNL 

ID50 



hh 


NNNNN 


hh 


NNNNN 


hh 


NNNNN 


hh 


NNNNN 


hh 


NNNNN 


hh 


NNNNN 


hh 


NNNNN 



o 
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Input 
Option 

ER 



Dayfile Action 
Code Used 

ER 



o 



Description 

A listing of all system processing 
errors (excluding RNCI errors). 



Sample output: 



PROCESSING ERRORS 



CIRCUIT 



NMC All dayfile messages with 

AWNO All dayfile messages with 

AWNC All dayfile messages with 

NEDNE All dayfile messages with 

NEDNW All dayfile messages with 

NEDNL All dayfile messages with 

ID50 All dayfile messages with 



code RSER for NMC 
code RSER for AWNO 
code RSER for AWNC 
code RSER for NEDNE 
code RSER for NEDNW 
code RSER for NEDNL 
code RSER for ID 50 



N "w F 



Input 
Option 

RE 



Dayfile Action 
Code Used 

PE 



Description 

CIRCUIT error summary. A listing of all 
CIRCUIT type errors. 



Sample output: 



CIRCUIT ERRORS 



CIRCUIT 



NMC All dayfile messages with 

AWNO All dayfile messages with 

AWNC All dayfile messages with 

NEDNE All dayfile messages with 

NEDNW All dayfile messages with 

NEDNL All dayfile messages with 

ID50 All dayfile messages with 



code 


RSPE 


for 


NMC 


code 


RSPE 


for 


AWNO 


code 


RSPE 


for 


AWNC 


code 


RSPE 


for 


NEDNE 


code 


RSPE 


for 


NEDNW 


code 


RSPE 


for 


NEDNL 


code 


RSPE 


for 


ID50 
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Input 
Option 

RH- 



Dayfile Action 
Code Used 

RN 



Sample output: 



RETRANSMISSION RATE 



O 





CIRCUIT 




HOUR 




NMC 




hh 




AWNO 




hh 




AWNC 




hh 




NEDNE 




hh 




NEDNW 




hh 




NEDNL 




hh 




ID50 




hh 


Input 


Dayfile 


Action 


Option 


Code 


Used 





SA 



Sample output: 



SL 



SECURITY ACCESS ATTEMPTS 



CIRCUIT 



Description 

Retransmission rates at hourly intervals 
for each circuit. The rate is the 
number of bits transmitted per hour. 



BIT TRANS. (10 thousands) 

NNNNN 
NNNNN 
NNNNN 
NNNNN 
NNNNN 
NNNNN 
NNNNN 

Description 

A listing of the dayfile message for 
each security access attempt. 



O 



NMC All dayfile messages with code RSSL for NMC 

AWNO All dayfile messages with code RSSL for AWNO 

AWNC All dayfile messages with code RSSL for AWNC 

NEDNE All dayfile messages with code RSSL for NEDNE 
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NEDNW All dayfile messages with code RSSL for NEDNW 
NEDNL All dayfile messages with code RSSL for NEDNL 
ID50 All dayfile messages with code RSSL for ID50 



Input Dayfile Action 

Option Code Used Description 

TH TP Throughput rates at hourly intervals for 

each circuit. The rate is the number of 
bits transmitted per hour. 
Sample output: 

THROUGHPUT RATE 

CIRCUIT HOUR BIT TRANS. (10 thousands) 

NMC hh NNNNN yj 

AWNO hh NNNNN 

AWNC hh NNNNN 

NEDNE hh NNNNN 

NEDNW hh NNNNN 

NEDNL hh NNNNN 

ID50 hh NNNNN 
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Input 
Option 

TO 



Dayfile Action 
Code Used 

TP 



Sample output: 



OVERALL THROUGHPUT RATE 



Description 

Overall throughput rate for each circuit 
of bits transmitted during the entire 
period of record. 



o 



CIRCUIT 


PERIOD 


BIT T 


RANS. (: 


NMC 


hh 1 -hh 2 




NNNNN 


AWNO 


hh 1 -hh 2 




NNNNN 


AWNC 


hh x -hh 2 




NNNNN 


NEDNE 


h^-hhj 




NNNNN 


NEDNW 


hh x -hh 2 




NNNNN 


NEDNL 


hh 1 -hh 2 




NNNNN 


ID50 


hhj-hl^ 




NNNNN 


TOTAL 


hh^hhg 




NNNNN 



o 
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7.0 DAYFILE MESSAGES 



Dayfile messages for CCS applications are shown in table 7-1. 
messages have a 4-character code followed by the message text. 



Dayfile 



TABLE 7-1. DAYFILE MESSAGES 



c 





Dayfile 


Program 


Code 


TQ 


RTAB 




RTIN 




RTIN 




RTIN 




RTIN 




RTIN 




RTIN 




RTIN 




RTIN 




RTIN 



Message 

xx = illegal state in TQ, event = yy 

ICN timeout message - mf skipped 

mf = mmm, state = yy 

State processed 

Ill-formatted ICN read response 

No trailing data header byte 

lfn = xxxxxxx, fnt = ffff , possibly locked on mf - nmm 

Invalid keyword = nnnnnnnnnn 

EOx after file header read 

Ill-formatted TQ file . EOx = nn 



RQ RRIN Invalid BSRB status - xx, fd 

m. c . r . 

RRIN ICN PF attach error = xx 

RRIN PF error = xx 

RRIN Catalog request 

RRIN Extend request 

RRIN Invalid ICN err = xxx 



= xxxx while reading 



RQIN 



ICN timeout occurred - request reissued 



o 



NM RNIN LTD in EST is greater than max valid LTE 

RNIN LTD in EST = xx and LTE = nn do not match 

RNIN Ill-formatted NM update from mn - xx 
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TABLE 7-1. DAYFILE MESSAGES (Contd) 



o 





Dayf lie 


Program 


Code 


ICNSUBS 




ICN 


ICAB 




ICAB 




ICAB 




ICAB 



Me ssage 

ICN not responding (via CTOI) 

Global common assign error = xx 
Too few pages assigned in gc 
ICN could not get global common 
INIT defevtq failed 



MRT RMOD * I Message Queued (Relates Message Context Information 

to CCS Message Sequence Number) 

RMRO * Message Requeued (message recovery) 

RMTX * Message Transmitted to Destination 

RMDD * Operator deleted Destination from Message 

RMDA * Operator added Destination to Message 

RMTD * Message has Timed Out after transmission (Retention 
expired) 

RMER * Error in MRT function encountered 



vy 



* Message formats shown in text. 



J 
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MRT has special message formats shown below: 



MRT Dayfile Message Format for dayfile code RMER: 

1 2 2 
1234567890123456789012345 

PPPP MM CCC NNNN XXXXXXXX 



Where: 
PPPP 
MM 
CCC 



O 



NNNN 
XXXXXXXX 



MRT caller's 
MRT caller's 
Error Code 



Process Number (Mailbox Ordinal) 
Mainframe Number 



ERR 

OK 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 



Unused 
Normal 



return, no error 

ICN/32 message too long 

Invalid command field 

Can't find message name 

Can't read message context 

Context portion too big for MRT buffer 

Ran out of Message Tables (see NMTS define) 

Ran out of Destination Tables (see NDTS) 

Ran out of Sinkgroup Tables (see NSGS) 

Ran out of Sink Tables (see NSTS) 

Dup or can't find Sink Group 

Dup or can't find Sink Name 

Event bit not defined 

Error when releasing Message File (timer) 
Conmand submitted for action 
Additional Information, depending on the error 



o 
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The format of the dayfile message for dayfile codes RMQD, and RMRQ: 



1 2 3 4 4 
123456789012345678901234567890123456789012345 

NNNN MMMMMMMMMMMMMMMMMMMMMMMMMMMMMM SSSSSSSS 

1 
4 5 6 7 8 9 
6789012345678901234567890123456789012345678901234567890 

GGGGGGGGPPPPMMFFTTLDDDRRRRLLLLIilRRRRRIIIIIIIDDDDDDDDDD 



Where: 
NNNN 

MMM MMM 

SSSSSSSS 

GGGGGGGG 

PPPP 

MM 

FF 

TT 

L 

DDD 

RRRR 

LLLLL 

RRRRRR 

IIIIIII 

DDDDDDDDDD 



CCS Sequence Number 

Message Identification 

Source Name 

Sourcegroup Name 

MRT caller's Process Number (Mailbox Ordinal) 

MRT caller's Mainframe Number 

Message Format 

Message Type 

Message Security Level 

Number of Destinations specified 

Retention Period in minutes 

Message length in bits / 100 

CCS receipt time (DDHHMM) 

IPS Jobname 

Date/Time Group (YYMMDDHHMM) 



V> 



MRT Dayfile Message Format for dayfile codes RMTX, RMDD, and RMDA: 

12 3 

123456789012345678901234567890 

NNNN SSSSSSSS GGGGGGGG PPPP MM 



Where: 
NNNN 
SSSSSSSS 
GGGGGGGG 
PPPP 
MM 



CCS Sequence Number 

Destination Sink Name 

Destination Sinkgroup Name 

MRT caller's Process Number (Mailbox Ordinal) 

MRT caller's Mainframe Number 
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MRT Dayfile Message Format for dayfile code RMTO: 

-0 1 
123456789012 

NNNN TIMEOUT 

Where: 

NNNN CCS Sequence Number 
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APPENDIX A 



ABORT CODES 



These abort codes appear in registers RC through RF of the task dump with a 
7/1 abort. Numeric values are in hexadecimal. 



o 



BSIO Aborts: 

RC RD 
1 











3 

4 



5 
6 
7 
8 
9 



RE 



Number of bits remaining 



EXPANDQ error status 

Write status error 

Read status error 

Bad header word 

Bad new word pointer 
value 



RF 


Routine 





BSPB 
(BSIWAB 
I/O 
reject) 





BSPB 

(full 

buffer 

by 

BSIDTB) 





BSPB 





BSIWAB , 
(Active 
write 
buffer 
is empty) 





BSICWS 





BSICWS 





BSICRS 





BSIDFB 





BSIDFB 
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ICN Aborts: 



o 



Description RC 

Global common 

assign error 

Too few GC pages Status from RELGC ESR 

Global common 

could not be 

attached 

DEFEVTQ error 



Buffer could not be Status why buffer 
linked to free couldn't be linked 
list 



RD 
1 



RE 



DEFEVTQ 
status 



Routine 



INIT 



INIT 



INIT 



INIT 



INITFL 



ICNSUBS Aborts: 
RC 

FFF10 
FF 

FFF12 



RD RE 

Out of bounds EST ordinal 

SETEVTQ status that 
was not zero 

Out of bounds Link 
Table ordinal that 
was being written 



RF 



Routine 
ICNWEST 
ISSUEIIB 

ICNWLTE 



s~"\ 



V > 



Link Driver Aborts: 

RC RD 

FFF00 Status from READLU ESR 



FFF01 Number of CCCs found 
in EST 

FFF02 Error status from 
ICNINIT 



RE 

Logical unit issued 
with READLU 

EST ordinal which 
caused this abort 



RF 



Routine 



CCCLD 



CCCLD 



CCLD 



c 



J 
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RC RD 



FFF03 ICN RG status response 



FFF04 ICNRS status response 



FFF05 Status from WRITLU to 
CCCMGR 

FFF06 Status from READLU ESR 
after WRITLU 



RE 

ICN mailbox ordinal 
receive performed on 

ICN mailbox ordinal 
ICNRS performed on 

Logical unit WRITLU 
was performed on 

Logical unit used in 
READLU ESR 



RF 



Routine 



CCCLD 



CCCLD 



CCCLD 



CCCLD 



o 



FFF07 Status from SETITMQ 

that caused this abort 

FFF08 Status from SETITMQ on 

a short mainframe timeout 
after setting a STANDARD 
mainframe timeout period 
that caused this abort 

FFF09 DEFEVTQ error status 

FFFOA Invalid unit status 
from CCCLUN 



CCCLD 



CCCLD 



DEFINEV 
DEVENT 



FFFOB Status from ICNSEND 
function 



MM 






FFFOC Invalid RG status from 
ICNRECV 

FFFOD Invalid status from 
ICNENQ 

FFFOE Status from DEVICEQ ESR 



FFFOF No more logical units 
available to assign 

FFF10 EST ordinal out of range 

FFF11 Invalid status return 
from ICNRIDT 

FFF12 Link Table Ordinal that 
was out of range 



RG 



Logical unit used in 
DEVICEQ ESR 



ASSIGNLU 

ASSIGNLU 

WRITEST 
GETOMF 

WRITELTE 
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RC RD 

FFF13 Length that was smaller 
than length of IPS ICN 
message header 



RE 



RF 



Routine 



CCLD 



o 



MBR Aborts: 



RC 



Bad mmsbuf 
index 



RD 



RE 



RF 



Routine 



MGETGC MRRINIT 
error code 

MRRWALK 



MET aborts: (RC and RF = 0) 



RD 



RE 



10 


icneng status q 


20 


icnget status 


30 


global common w 


40 


error 


50 


error 


60 


error 


70 


icninit status 


80 


incridt status 


90 


error 


100 


error 


110 





120 





130 


nnnn 


140 





150 


icnsend status 



Description Routine 

icneng return not » COMPLETE Getmsg 

icnget return not = COMPLETE Getmsg 

Inconsistent initial buffer Init 
allocation 

ASNGC esr error Init 

ASNGC couldn't get enough Global Init 
Common 

MGETGC esr errors Init 

icninit result not = COMPLETE Init 

incridt result not = COMPLETE Init 

DEFEVTQ esr error (timer def) Init 

SETITMQ esr error Init 

Duplicate Sequence Number file Init 

No Seq Num file found (SEQnnnn.CCS) Init 

Bad nnnn in "SEQNnnnn.CCS" file Mrtrmn 

MRTRNM not initialized Mrtrmn 

icnsend return not = COMPLETE Mrtrmn 



v./ 



C 
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RD 



RE 



Description 



Routine 



160 - - error 

162 icnsend status 

164 error 

166 icnsend status 

170 mnisbuf location 



SAVEQ esr error Mrtrmn 

icnsend return not = COMPLETE Mrtrsm 

SAVEQ esr error Rmf 

icnsend return not = COMPLETE Sotasgn 

Bad index to mmsbuf found by WALK. Walk 

Index found in mmsbuf location to 
be out of GC range 



o 



NM Aborts: 

RC 
BBB01 



RD 



o 



ICN status from ICNRECV 
function 



BBB02 RATFOR symbol COMPLETE 
is nonzero. 

BBB03 ICNINIT status 

BBB04 DEFEVTQ status after 
assigning timer 

BBB05 SETITMQ status after 
setting an interval 
timer 

BBB06 ICN status response 
after sending ICNWMT 
request 

BBB08 ICN status response 
after sending status 
request response 

BBB09 ICN status error 

from reading machine 
table 

BBBOA ICN status error 

from sending SSR ICN 
message 



RE 



RF 



Routine 

NM 

CHKSTAT 

NMINIT 
NMINIT 

NMINIT 

CMT 

SR 

SSR 

SSR 
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O 



RC RD 

AAA02 Length of global 
context record 



AAA04 Length of BSIO buffer 
(maximum) 



AAA03 ICNSEND status 
(MRT function) 

AAA04 DEFEVTQ status 
(timer event) 

AAA05 SETITMQ status 

AAA06 UST status 

(BSIO logical unit) 

AAA07 Invalid path ordinal 

AAA08 Invalid SETITMQ status 
(ICN timeout FOREVER) 

AAA09 Invalid ICNSEND status 
(sending to SOT) 



RE 

Length of PFM buffer 
into which the global 
context record is to 
be placed 

Length of PFM buffer 
(+2) to be used by 
BSIO 



RF 



FFFOO 


ICNSEND status 




FFF10 


Number of words 
requested 


Maximum size PFM 
buffer available 


QU Abort 


s: 




RC 


RD 


RE 


AAAOO 


ICNINIT status 




AAA01 


DEFEVTQ status 

(ICN timeout timers) 




AAA02 


DEFEVTQ status 
(MRT event) 





SETITMQ event bit 



RF 



Routine 



NMCBCR 



IXINIT 
GETFREEW 



Routine 

QINIT 

QINIT 

QINIT 

QINIT 

QINIT 

QINIT 
QDE 

RQ QUEUE 
RQQUEUE 

RQQUEUE 
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O 



RC RD 

AAAOA Invalid ICNRECV status 

AAAOB Unknown event bit 

AAAOC Invalid BSIO LUN 

AAAOD Path number 



AAAOE Invalid ICNSEND status 
(sending msg) 

AAAOF Invalid SETITMQ status 
(setting timeout timer) 



AAA10 


BSIO 


fd 


(BSOPEN) 


AAA11 


BSIO 


fd 


(BSGLUN) 


AAA12 


Unknown output msg 
status in QSINKMAP 


AAA13 


ERR i 


from BSCRE8 


AAA14 


ERR 1 


from BSGLUN 


AAA15 


Max bits for internal 
buffer (NO EOC) 


AAA16 


BSIO 


fd 


(BSRTOP) 


AAA17 


BSIO 


fd 


(BSPB) 


AAA18 


BSIO 


fd 


(BSRB) 


AAA19 


BSIO 


fd 


(BSEOD) 


AAA1A 


BSIO 


fd 


(BSPB) 


AAA1B 


BSIO 


fd 


(BSEOC) 


AAA1C 


BSIO 


fd 


(BSCLOS called) 


AAA1D 


BSIO 


fd 


(BSCLOS) 



RE 


RF 


Routine 
RQQUEUE 
RQ QUEUE 
RQQUEUE 


Next state path 

was going to execute 


evflag 

causing 

abort 


RQQUEUE 



Error from BSRB 



RQQUEUE 

RQQUEUE 

Q INITIAL 
Q INITIAL 
QSTATEA 

QSTATEB 
QSTATEB 
QSTATEC 

QSTATED 
QSTATEE 
QSTATEF 
QSTATEH 
QSTATEI 
QSTATEJ 
QSTATEK 
QSTATEG 



o 
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RQ Aborts: 



RC RD 

FFFOO ICN status from 

initialization call 

FFF01 Status from DEFEVTQ 
for defining ICN 
timeout event bits 

FFF02 Status from DEFEVTQ 
for defining MRS 
event bits 

FFF03 Status from ICNREAD 
id table function 

FFF04 Status from DEFEVTQ 
for defining ICN 
interval timer 
event bit 

FFF05 Status from SETITMQ 
for setting 
interval timer 

FFF06 BSIO unit status from 
UST ESR 

FFF07 Status from read ICN 

Machine Table function 

FFF08 fd as returned by 
BSOPEN routine 

FFF09 First 4 characters 

of invalid sinkgroup 
name from MRRSNM 

FFFOA Status from ICNGET 

FFFOB Status from SOTCMD 
ICNSEND function 

FFFOC ICN message response 
byte that was invalid 



RE 



RF 



Event bit used for 
interval timer 



Last four characters 
of invalid sinkgroup 
name from MRRSNM 



Routine 
RQINIT 

RQINIT 
RQINIT 

RQINIT 

RQINIT 

RQINIT 

DE 
CAM 
DSS 
DSS 

RQ 

RQ 

VIR 



v„^ 
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RC RD 

FFFOD Invalid status from 
ICNENQ status 

FFFOE Invalid path number 
in ICN message 

FFFOF Unknown event bit 
encountered 

FFF10 BSIO lun not a proper 
value 

FFF11 path that stopped 
improperly 



RE 


RF 


Routine 
RQ 

RQ 

RQ 

RQ 


state path was to 


unknown 


RQ 


execute next 


event flag 
encountered 





c 



o 



FFF12 Status from ICNSEND of 
an ICN message to IPS 

FFF13 Status from SETTINQ 
ICN message timeout 
interrupts 

FFF14 BSIO fd (tried to close) 

FFF15 First 4 characters 

of file that was not 
BSOPEN'd whose lun 
could not be obtained 

FFF16 First 4 characters of 
pfn that was invalid 
(from FDB) 

FFF17 First 4 characters of 
lfn that was invalid 
(from lfn) 

FFF18 fd of bsio file that 
could not be BSRTOD'd 

FFF19 Negative (or zero) bits 
encountered in state 

FFF1A fd of file that BSRB 
wanted from BSRB 
caused the error on 



Second 4 
characters of file 



Second 4 characters 
of pfn 



Second 4 characters 
of lfn 



fd 



Number of bits 



RQ 
RQ 

PIT 
DSS 



CPFR 



CPFR 



RQSTATED 

RQSTATEE 

ERR or EOC RQSTATEE 
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RC RD 

FFF1B fd of file that BSCLOS 
could not close 

FFF1C Status from ICNHtlT that 
caused this abort 

FFF1D First 4 characters of 
sinkname not found 

FFF1E Status from SETTINQ ICN 
timeout event to FOREVER 

FFF1F Number of characters 
in parameter 

FFF20 Illegal SOT parameter 
value 



RE 



Second 4 characters 
of sinkname not found 



RF 



SOT parameter number 
that caused this error 



Routine 



RQSTATEH 



DSS 



DSMI 



RQ 



SOTCMD 



SOTCMD 



o 



FFF21 Illegal file type 
parameter 

FFF22 ICNRIDT error status 

FFF23 DEFEVTQ ESR status 
error 

FFF24 ICN status error in 
sending MRTRSGN 
function message 

FFF25 DEFEVTQ error status 

from clearing sinkgroup 
event bit definition 



SOTCMD 

SOTCMD 
CAM 

RQRSGN 
RQRSGN 



\^s' 



FFF26 DEFEVTQ error status from 
defining sinkgroup name 
event bit definition 

FFF27 ICN status error in 

sending MRTDSGN function 
message 

FFF28 ICN status error in 

sending MRTRSM function 
message 

FFF29 Invalid file type 
parameter 



RQDSGN 



RQDSGN 



RQRSM. 



OSNS 



o 
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SOT Aborts: 

RC 



RD 
FE 
FF 
FD 



RE 
ICNINIT status 
ICNRIDT status 
Illegal TTY # 



RF 



Routine 
INIT 
INIT 
SENDMB 



o 



RE 

lun that caused 
invalid status 



Maximum size ICN message 
TQ can accept 



o 



TQ Aborts: 

RC RD 

EEEOO Invalid UST status 

EEE01 Invalid ICNENQ status 

EEE02 Length of ICN message 
received from ICN 

EEE03 Invalid ICNGET status 

EEE04 Path number that was 
outside valid range 

EEE05 Invalid ICNSEND status 

EEE06 Invalid SETITMQ status 

EEE07 Invalid DEFEVTQ status 

EEE08 Invalid ICNRMT status 
return 

EEE09 Invalid ICNINIT status 

EEEOA Invalid ICNRIDT status 

EEEOB Unknown security code in 
FNT on IPS 



EEEOD Invalid state encountered Invalid event 

encountered 
EEE10 BSIO fd that caused 
BSCRE8 to return ERR 



RF 



Routine 
TQ 

TQ 

TQ 

TQ 
TQ 

IIR 
IIR 
INITTQ 
TQ 

INITTQ 
INITTQ 
RSPLF 

ES 
STATEE 
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RC RD 

EEE11 BSIO fd that caused 
BSGLUN to return ERR 

EEE12 BSIO fd that caused 
BSPB to return ERR 

EEE13 BSIO fd that caused 
BSEOD to return ERR 

EEE14 BSIO fd that caused 
BSEOR to return ERR 

EEE15 BSIO fd that caused 
BSPB to return ERR 

EEE16 BSIO fd that caused 
BSEOC to return ERR 

EEE17 BSIO fd that caused 
BSCLOS to return ERR 

EEE20 Invalid ICNGET status 

EEE21 Invalid ICNSEND status 
of SOT response 

EEE22 Illegal SOT command 
ordinal 

EEE30 Invalid SETITMQ status 

EEE31 Invalid SETITMQ status 

EEE32 Invalid DEFEVTQ status 

EEE33 . Number of destination 
specific entries in 
message header that 
overflowed TQ buffer 



RE 



RF 



Data length that caused STATEG 
BSEOD to return ERR 



SOT parameter 



Routine 



STATEE 



STATEG 



STATEG 
STATEJ 

STATEK 

STATEL 

TQ 
TQ 

SOTCMD 

TQ 

INITTQ 
INITTQ 
BUILDMCR 



o 



\-...y 
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RC 



RD 



RE 






$ 100 


St 





$ 110 


St 





$ 120 


i 





$ 121 


i 





$ 130 


St 





$ 131 


St 





$ 132 


St 



RF Description 

ICNINIT call returned not complete 

ICNRIDT call returned not complete 

Error in DEFEVTQ esr for AWNIN SG 

Error in DEFEVTQ esr for AWNOUT SG 

ICNSEND call for MRTDSGN not complete 

ICNSEND call for MRTDSN AWNIN not complete 

ICNSEND call for MRTDSN AWNOUT not complete 



AWNDC Aborts - Routine EVNOUT 



RC 



RD 



RE 



RF 



Description 



o 






$ 200 


St 





$ 210 


st 





$ 201 


St 





$ 202 


St 



ICNSEND call for MRTRMN not complete 

ICNRECV call for MRTRMN not complete 

ICNSEND call for MRTRSM not complete 

ICNSEND call for MRTRM not complete 



AWNDC Aborts - Routine EVNIN 



RC 



RD 



RE 



RF 



Description 






$ 300 


St 





$ 310 


st 





$ 301 


st 





$ 302 


st 



ICNSEND call for MRTRMN not complete 

ICNRECV call for MRTRMN not complete 

ICNSEND call for MRTRSM not complete 

ICNSEND call for MRTRM not complete 



AWNDC Aborts - Routine ABT 



RC 



RD 



RE 



o 






$1000 


fdr 





$2000 


fdr 





$2901 


fdr 





$1001 


fdw 





$3000 


fdw 





$3001 


fdw 





$4000 


fdr 





$4001 


fdw 





$3002 


fdw 





$3003 


fdw 



RF Description 

CONTOAW - bsopen err on outbound msg file 

CONTOAW - bsrb err from outbound msg file 

CONTOAW - EOD encountered during bsrb 

C0NAS2B - bscre8 err on temp msg file 

C0NAS2B - bspb err on temp msg file 

C0NAS2B - bseoc err on temp msg file 

C0NAS2B - bsclos err on outbound msg file 

C0NAS2B - bsclos err on temp msg file 

AWNSOM - bspb err with SOM on temp msg file 

AWNSOM - bseor err on temp msg file 
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o 



RC 


















































RD 

$2002 
$4002 
$4003 

$3004 
$3005 
$3006 

$1002 
$1003 
$2003 
$2004 
$2905 
$3007 
$3008 
$2006 
$3009 
$3010 
$3011 
$2007 
$2008 
$2909 
$3012 
$3013 
$4004 
$4005 

$1004 
$2010 
$2 911 
$2012 
$2013 
$2914 
$1005 

$4006 
$4007 
$3014 

$4008 
$4009 
$3015 

$3016 
$3017 

$3018 



RE 

fdr 
fdw 
fdr 

fdw 
fdw 
fdw 

fdtemp 

fdnew 

fdtemp 

fdtemp 

fdtemp 

fdnew 

fdnew 

fdtemp 

fdnew 

fdnew 

fdnew 

fdtemp 

fdtemp 

fdtemp 

fdnew 

fdnew 

fdnew 

fdtemp 

fdr 
fdr 
fdr 
fdr 
fdr 
fdr 
fdw 

fdw 
fdr 

fdw 

fdw 
fdr 
fdw 

fdw 
fdw 

fdw 



— Description 

AWNSEG - bsrtod err on outbound msg file 

AWNSEG - bsclrem err on temp msg file 

AWNSEG - bsclos err on outbound msg file 

WRSEG - bspb err with seg on temp msg file 

WRSEG - bseod err on temp msg file 

WRSEG - bseor err on temp msg file 

NEWMSG - bsopen err on temp msg file 

NEWMSG - b sere 8 err on new out msg file 

NEWMSG - bsrtod err on temp msg file 

NEWMSG - bsrb err from S0M on temp msg file 

NEWMSG - EOD encountered during bsrb 

NEWMSG - bspb err on SOM to new msg file 

NEWMSG - bseor err after SOM on new msg file 

NEWMSG - bsrb err from seg on temp msg file 

NEWMSG - bspb err on seg to new msg file 

NEWMSG - bseor err after seg on new msg file 

NEWMSG - bseod err after seg on new msg file 

NEWMSG - bsrtoc err on temp msg file 

NEWMSG - bsrb err from context on temp msg 

NEWMSG - EOD encountered during bsrb 

NEWMSG - bspb err on context to new msg file 

NEWMSG - bseoc err to new msg file 

NEWMSG - bsclos err on new msg file 

NEWMSG - bsclrem err on temp msg file 

CONFRAW - bsopen err on inbound msg file 

CONFRAW - bsrb err from context on inbound msg 

CONFRAW - EOD encountered during bsrb 

CONFRAW - bsrtod err on inbound msg file 

CONFRAW - bsrb err from SOM on inbound msg file 

CONFRAW - EOD encountered during bsrb 

CONFRAW - bscre8 err on new inbound msg file 

CONB2AS - bsclrem err on new inbound msg file 

C0NB2AS - bsclos err on inbound msg file 

C0NB2AS - bseod err on new inbound msg file 

C0NB2BN - bsclrem err on new inbound msg file 

C0NB2BN - bsclos err on inbound msg file 

C0NB2BN - bseod err on new inbound msg file 

WRCTEXT - bspb err on new inbound msg file 

WRCTEXT - bseoc err on new inbound msg file 

WRBLK - bspb err on new inbound msg file 
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st - ICN routine return status 

i = iesr status 

fdr = file descriptor of file being read 

fdw = file descriptor of file being written 

fdtemp = file descriptor of temp msg file 

fdnew = file descriptor of new msg file 



O 
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APPENDIX B 



MPX/OS USAGE SUMMARY 



Disclaimer: This information is extracted from MPX/OS manual and is not 
guaranteed to be updated when MPX/OS manuals are updated. 



o 



o 
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Editor Summary - ]J under ICF 



Special Character Usage 

? Matches any character (except newline) 

% Indicates beginning of line 

$ Indicates end of line or end of file 

[...] Character class (any one of these characters) 

[*...] Negated Character class (any character except these) 

* Closure (zero or more occurrences of previous pattern) 

@ Escaped character (e.g. @% , @[, @*) 

& Ditto, i.e. whatever was matched 

cl-c2 Range of characters between cl and c2 

@n Specifies the newline mark at the end of a line 

nn Specifies "go to column" in a pattern search 



COMMAND SIMMARY 



Addresses: 



17 a decimal number 

the "current" line 

$ the last line of the file 

/pat/ search forward for line containing pat 

pat search backward for line containing pat 

line+n n lines forward from line 

line-n n lines backward from line 



V.../ 



Defaults: 



(.) use current line 

(.+1) use the next line 

(.,.) use current line for both line numbers 

(1,$) use all lines 



Commands : 



(.) 

(...) 
(...) 



a 
b 
c 
d 
e 
f 
f 
h 



file 

file 
file 



append text after line (text follows) 

submit file for batch execution 

change text (text follows) 

delete text 

discard current text, enter file, remember file name 

print file name 

remember file name 

print help information 



( 
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O 



(.) 


i 


(...) 


k line3 




1 col, col 


(...) 


m line3 




o seq 


(...) 


P 




q 


(.) 


r file 


(...) 


s/pat/new/gp 




t 




t c 




t col, . . ,col 




u 


(1,4) 


w file 




za file 




zo col, col 


(.) 


=P 


(.+1) 


CRl 


U,t) 


g/pat/command 


(l.fc) 


x/pat/command 



insert text before line (text follows) 

copy text to after line3 

set line display window 

move text to after line3 

retrieve output file from queue 

print text (can be appended to other commands) 

quit 

read file, appending after line 

substitute new for leftmost pat 

(g implies all occurrences) 

display tab columns 

set tab character 

set tab columns 

toggle uppercase forcing 

write file, leave current text unaltered 

(if "file" isn't given, write to current filename) 

delete file 

set search zone 

print line number, current line 

print next line 

repeat last command 

do command on lines containing pat 
(except a, c, i, q commands) 
do command on lines not containing pat 
(except a, c, i, q commands) 
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Facility Command Summary 



G 



BATCH CONTROL FACILITY 
Bsp seqno, b Iks 
End seqno 

REPeat seqno, times 
REWind seqno, prior 
Suppress seqno 

DEVICE CONTROL FACILITY 
Go pdc 
OFf pdc 
ON pdc 
Read pdc 
SEtdc pdc.sdc 
STatus 
Wait pdc 



Backspace a file on a device 
Terminate transmission of a file 
Cause repeated transmission 
Rewind and return to queue 
Suppress carriage control 



Resume "waited" file transmission 

Make equipment logically off 

Make equipment logically on 

Take input from equipment 

Set secondary disposition code 

List equipment 

Suspend file transmission 



pdc 



Primary Disposition Code (2 characters, installation 
defined, unique to equipment) 



DAYFILE MANAGEMENT FACILITY 
Archive 
Dump fn,own,ed ,ak,sydt ,eydt 

Type JN=jn,TN=tn,ID=id,EV=ev,AC=ac 
Type ALL 



Save current dayfile 

Select dayfile entries between 

sydt and eydt at Y.DDD.HHMM. 

Set selection criteria for dump: 
jn = job name (8 ch) 
tn = task ident (8 ch) 
id = ident code (1 ch) 
ev = event code (1 ch) 
ac = action code (2 ch) 



y_y 



FILE CONTROL FACILITY 
List 0, own, pack 
List A, own, pack 
List D 

Release, fn,own,ed ,ak,R 
Release, fn,own,ed,ak 

OPERATOR CONTROL FACILITY 
Accept seqno, taskid,message 
Clear 

Display fwa, lwa 
Evict seqno, q 
Go seqno, taskid 
Idle seqno, taskid 



Open files 

All files 

Device Idents and % full 

Release unused space 

Release whole file 



Accept a message 

Clear Informative messages 

Display memory 

Remove file from queue (q= I,0,H) 

Resume an "idle" task 

Idle a task 
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Lastpage * 

Nextpage 

Priority seqno, q, prior 

Queue 

Queue , q 

Reject seqno, taskid, message 

Set adr,val,val,val. . . . 

Set adr,rep*val,rep*val. .. 

Term seqno 

Update 

Watch 

Watch seqno 

Watch seqno, taskid 
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Display previous memory 
Display next sequential memory 
Alter file priority (q= I,0,H) 
Display state of all queues 
Display specific queue (q= I,0,H) 
Reject a message 
Change memory 

Change memory, rep= num of words 
Terminate a job 

Repeated execution of last cmd 
Display state of executing jobs 
Display state of job & its tasks 
Display state of single task 
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APPENDIX C 



VALID COMMAND INPUTS 



Destination 


Destination 


Group 


* 


(within group shown) 


N/A 




NMCDATA 


N/A 




AWNDATA 


N/A 




ARQDATA 


N/A 




ID50DATA 


N/A 




NEDNDATA 


MED 




OPRMSG 



o 



* For circuit destined data use entity names from port list. These names 
should be the FNOC defined names so data destined to circuits from IPS 
matches the port destinations. 
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APPENDIX D 

CCS BUILD CONSIDERATIONS 

The following routines must be in the MPX library: 

ICNENQ - Enquire about the contents of a mailbox 

ICNGET - Get the contents of a letter 

ICNINIT - Initialize the Interface to ICN (Post Office) 

ICNRECV - Enquire about the status of a mailbox and get the contents of 

the letter 
ICNREST - Reads an ICN EST entry 
ICNRIDT - Reads the ICN ID Table 
ICNRLTE - Reads an ICN Link Table Entry 
ICNRMT - Reads the ICN Machine Table 
ICNWMT - Writes the ICN Machine Table 
ICNRS - Requests ICN statistics 
ICNSEND - Sends a message to another task via ICN 
ICNWEST - Writes an ICN EST entry 
ICNWLTE - Writes an ICN Link Table Entry 
BEOR - Mark End-of-Record in Context or Content 
BSEOC - Mark End-of-Context 

BSEOD - Mark End -of -Content and St art-of -Context 
BSCLOS - Close the Message file (MPX/OS CLOSE) 
BSCLREM - Close and Remove a "bscre8"ed file 

BSCRE8 - Creates a new Message file (MPX/OS ALLOCTATE & OPEN) 
BSOPEN - Open an existing Message file 
BSPB - Write Context or Content data (Pack bits) 

BSRB - Read Message Context or Content 
BSRTOC - Rewind to Start-of-Context 
BSRTOD - Rewind to Start-of-Content 
MRRINIT - Initialize Message Routing Reading package 
MRRMD - Read Message Destinations 
MRRMI - Read Message Information 
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MRSMI - Read Sink's Message Information 

MRRMSS - Read Message Storage Statistics (for flow control) 

MRRSNM - Read Sinkgroup's Next Message 

MRRSQD - Read Sinkgroup Destinations 
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APPENDIX E 



DISPLAYS FOR PA, PB, AND PC COMMANDS 



Entity Name List display 
Display format: 



ORD NAME 



TYPE 



ENTITY DISPLAY 
STATUS MODE PORT 



SUBORDINATE TO 



oo 



nnrmn tttt 



sss 



m 



PP 



sssss 



oo imnnri tttt sss m pp sssss 

End of ELIST 
where : 

oo - ordinal number 

nnnn - entity name 

tttt - protocol (NEDN, NEDS, AWN, ID50, NMC) 

sss - port status (ON, OFF) 

m - mode - for type NEDN: 

A - wait and send to NEDS when they are all online 

B - send to all NEDS; those offline will lose the 
message 

C - send to available NEDS now; wait and send to 
others when available 

for type AWN: 

D - double buffer 

S - single buffer 
pp - port number 
ssss - subordinate entity name 



o 
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Sample displays: 



ENTITY DISPLAY 



ORD 



NAME 



TYPE 



STATUS 



MODE 



PORT 



SUBORDINATE TO 






NEDNE 


NEDN 


1 


KNGUE 


NEDS 


2 


NORVE 


NEDS 


3 


KNSSE 


NEDS 


4 


LERTE 


NEDS 


5 


ROTAE 


NEDS 


6 


NMCCE 


NEDS 


7 


NEDNW 


NEDN 


8 


KNPMW 


NEDS 


9 


PERLW 


NEDS 


10 


KNPNW 


NEDS 


11 


KNWCW 


NEDS 


12 


GUAMW 


NEDS 


13 


NEDNL 


NEDN 


14 


KQNAO 


NESN 


15 


AWNOO 


AWN 


16 


OFFUT 


AWN 


17 


AWNCO 


AWN 


18 


CARSW 


AWN 


End of 


ELIST 





ON 

ON 

ON 

ON 

OFF 

ON 

ON 

ON 

ON 

ON 

ON 

ON 

ON 

OFF 

OFF 

ON 

ON 

ON 

ON 



B 
D 



2 
3 
4 









ENTITY DISPLAY 


ORD 


NAME 


TYPE 


STATUS MODE PORT 


19 


ID50 


ID50 


ON 5 


20 


AGFWC 


ID50 


ON 


21 


NMC 


NMC 


ON 6 


22 


NMCSU 


NMC 


ON 


End of 


ELIST 







NEDNE 
NEDNE 
NEDNE 
NEDNE 
NEDNE 
NEDNE 

NEDNW 
NEDNW 
NEDNW 
NEDNW 
NEDNW 

NEDNL 

AWNO 

AWNC 



SUBORDINATE TO 

ID50 
NMC 
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Port List display 
Display format: 

PORT CONFIGURATION DISPLAY 
ORD CIRCUIT STATUS MODE STATIONS 



PP 



ccccc 



sss 



m 



o 



%/ 



nnnnn nnnnn imnnn 
nnnnn nnnnn nnnnn 



PP 



ccccc 



sss 



m 



nnnnn nnnnn nnnnn 



End of PLIST 
where : 

pp - port number 

ccccc - circuit name 

sss - port status (ON, OFF) 

m - mode - for type NEDN: 

A - wait and send to NEDS when they are all 

online 
B - send to all NEDS; those off-line will 

lose the message 
C - send to available NEDS now; wait and send 
to others when available 

for type AWN: 

D - double buffer 
S - single buffer 
nnnnn - station name 



Sample display: 



PORT 


1 

2 
3 
4 



CIRCUIT 

NEDNE 

NEDNW 

NEDNL 

AWNO 

ANWC 



PORT CONFIGURATION DISPLAY 

STATUS MODE STATIONS 

UP A 

UP A 



OFF 

UP 
UP 



B 
D 



KNGUE 


NORVE 


KNSSE 


LERTE 


ROTAE 


NMCCE 


KNPMW 


PERLW 


KNPNW 


KNWCW 


GUAMW 




KQNAO 






OFFUT 






CARSW 







End of PLIST 
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Display format: 



STATUS DISPLAY 



^Smm*^ 



Statistics reset hh:mm:ss 

CIRCUIT PORT MODE STATUS STATE ERRCT VOL MESSAGESEQ 

ccccc pp m sss tttttt ee vww mmmm 



ccccc 



PP m 



SSS tttttt ee VWW nuimm 



STATION STATUS 
nnnnn sss 



STATION STATUS STATION STATUS 
nnnnn sss nnnnn sss 



nnnnn 



sss 



nnnnn 



sss 



nnnnn 



sss 



where: 

hh:mm:ss - time statistics reset in format hours, minutes, seconds 

hh - hours 

mm - minutes 

ss - seconds 
ccccc - circuit name 
pp - port number 
m - mode - for type NEDN: 



y_y 



A - wait and send to NEDS when they are all online 
B - send to all NEDS; those off-line will lose the 

message 
C - send to available NEDS now; wait and send to 

others when available 



for type AWN: 

D - double buffer 
S - single buffer 



c 
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ssss - port or station status (ON, OFF) 

state - circuit state (IDLE, ACTIVE) 

ee - error count 

vwvv - volume 

mmmm - message sequence number 

nnnnn - station name 



Sample display: 



STATUS DISPLAY 



Statistics reset 13:45:00 
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CIRCUIT PORT MODE STATUS 



O 



NEDNE 



NEDNW 



UP 



UP 



STATE 


ERR CT 


VOLUME 


MESSAGE SEQ 


IDLE 





51638 




ACTIVE 


2 


95832 


9482 


ACTIVE 





5871 


9484 


ACTIVE 





20884 


9482 



NEDNL 



OFF 






STATION 


STATUS 


STATION 


STATUS 


STATION 


STATUS 


KNGUE 


UP 


NORVE 


UP 


KNSSE 


UP 


LERTE 


OFF 


ROTAE 


UP 


NMCCE 


UP 


KNPMW 


UP 


PERLW 


UP 


KNPNW 


DOWN 


KNWCW 


UP 


GUAMW 


UP 


KQNAO 


OFF 


OFFUT 


UP 


CARSW 


UP 


AGFWC 


UP 


NMCSU 


UP 
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